To: Jonothon Soft wore end Hordwore 

From: George Cossey 
Dote: July 25, 1985 

Subject: Jonothon Softwore Compotibllity with Moclntosh. 



Macintosh compatibility and the Jonathan. 

A primary goal of the Jonathan software is to be compatible with the 
current shipped Macintosh software, and stay as much compatible as 
possible with future versions of the Macintosh. Since the Macintosh ROMs 
were used as a base to start this project we have started with complete 
compatibility with that version of the ROM (which was somewhat 
incompatible with the current Macintosh). 

Whenever possible, the Jonathan software will be made compatible 
with the Macintosh software. There may be cases where the software is 
incompatible if the application writer uses system calls In an illegal or 
extremely non-standard way. 

There will always be differences In the software and the hardware 
that will cause some incompatibility problems. 

Some of the things that can cause mcompatahWty are the foHowing: 

a) Jonathan specific commdnds being added, mostly In the color area. 

b) Midi - Mac $pec1fic commands bei ng added that do not appi y to the Jonathan. 

c) Modules of different types and functions. Jonathan modules are more of a co- processor 
type, while Midi - Mac modules are more 11 ke the Apple 1 1 and I BM PC. 

d) Data structure differences. Jonathan records are a superset of the Macintosh records, 
color fields have been added for Jonathan. Jonathan supports both types of records vith 
optimization done for the Jonathan size. 

e) Different CPUs result in exception frames being different. This means (tebuggers have 
to change. And in order to take advantage of the new 68020 commands, assemblers & compilers 
will have to change slightly. 

f) The Interrupt structure Is different. Jonathan interrupt levels are different from 
Macintosh because there are different devices that need to interrupt. 

g) The Front Desk Buss on the Jonathan makes the Internal Interface to all mouse, 
keyboard, time, and parameter memory routines different. The access at the hardware level Is 
different, this will not normally affect application programs since they acces these functions at 
a higher level. 

h) Hardware address and function differences will affect programs that use the hardVi'are 
directly, such as some music programs and some copy protection methods. 

1) Harefle addresses are changed from Macintosh. The Macintosh used the upper address 
bits as data holders for handles. Since the Jonathan uses all address bits as atWress bits, these 
bits are In a different place on the Jonathan. This area is currently being addressed. 
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j) The Jonathan is a fore-runner to more advanced operating aystems that allov multiple 
applications to be running at the aame time. To atart making the transition to these operating 
systems, the Jonathan runs it's applications in the user mode of the 68020. This means that 
there are some instructions that an application program can not nov use. 



What does compatibility mean? 

Compatibility means that the Jonathan vill run most Macintosh applications (see the 
compatability problems above). We vill have to come up with a list of programs that vill run 
vhen ve ship. We should start contacting vendors that are using questionable programming 
methods nov, the 68000 ROM group has a list of some of these, and request some changes for 
thier future versions. 

Macintosh programs vill run under the Jonathan PlayPen (Finder) and may not be able to 
boot themselves up (to be determined). 

Traps. 

The traps being used on the current version of the Macintosh vill be the sarrtt on the 
Jonathan. Additional traps being used on the Midi -Mac and on the nev Macintosh ROMs may not 
be compatible due to the need of different functions on each system. 

Sound, Including voice. 

There are some, a small number, applications vritten by 3rd party people that use the 
sound buffer directly. We may not have to be concerned vith them, only as far as trying to 
making sure that they do not clobber our O.S. if they are run. All other calls should be system 
level and ve should be able to simulate the ones that make music. The ones that generate voice 
could be extremely hard to decode and simulate. Since ve vill have our ovn voice, and it vill be 
much better, ve should be OK. 

PWM buffer. 

This is a speed control buffer used on the older single sided Sony disk drive. Since ve are 
planning on using the double sided Sony drive, vhich has the speed control built on board, ve 
vill not have this function. So, ve vill not support an older type drive as our Internal drive. 
Since modules can do anything, it is possible to place an IWM and a PWM buffer or equivalent on 
a module as an add-on board. 

Single sided diskettes vs double sided diskettes. 

We vill be capable of reading and vriting in single or double sided format, both can be 
done on the double sided drive. By vriting in a single sided format, our data disks could be used 
on the current Macintosh. 
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Seriol communicotions. 



There has been e unable syatem level serial package available for the Macintosh from the 
start. We should have little trouble there, even if the SCC is located at a different memory 
location. 

Copy protection on existing Mac disks. 

The more advanced copy protection schemes on the Macintosh are now directly talking to 
the IWM and the VIA chips. To fully support these is impossible vlth our hardware design. We 
vill be compatible vith the "Apple approved" method of copy protection, this is alternate 
address and data marks. Any other method that talks directly to the hardware will probably not 
work. 

Finder. 

The Finder is really a DOS (Disk Operating System). In our environment we would need a 
device operating system that can handle all the modules that are being defined for the Jonathan, 
and all those that 3rd party people will develop. We need to have an idea of how each device could 
interface and be serviced by this device operating system. The Finder is currently used just to 
handle the disk drive and to launch programs. Our system will probably have to manage a lot 
more and may hove a different "look". 

New file systenn. 

The new file system will be used on Jonathan. This makes us compatible with current 
Macintosh diskettes as well as those that will come out under the new file system. 

Hard disk, direct connect. 

Since we do not have an external disk connector (IWM style), we will not support the 
direct connect hard disk. There will be hard disk modules available for Jonathan. 
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Dole: 07/29/85 



From: George Cossey 

Subject: Whot is Jonothon Soflwore. 



This is an attempt to describe the current direction that the software 
for the Jonathan is taking. Suggestions, comments, and discussion are 
welcomed for all aspects of the software. 



Major features. 

1. CompaiWflfiy with current Macintosh software to take advantage of 
existing software at introduction, while still expanding the software to a 
more advanced state. Designed to stay as compatible as possible with future 
products. 

2. Easy module software add-on capability to the System software. 

a) for Smart modules, acting as co-processors. 

b) for Dumb modules, such as serial port and parallel port cards. 

3. Front Desk Bus support, for all new devices on the FDB. Easy addition 
of new FDB devices as more are invented. 

4 Advanced QuickdrdYV, including color and other features. 

5. High quality color imoges as an integral part of the graphics. 

6. New file system which better supports hard disks. 

7. Larger screen size, 640 x 460. 

6. Color modes without any decrease in screen resolution: 

a) Black and White, 1 bit per pixel. 

b) Four colors, 2 bits per pixel. 

c) Sixteen colors., 4 bits per pixel. 

d) 256 colors, 8 bits per pixel. 

e) 65536 colors, 16 bits per pixel. 
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6ool8. 



1. As crcfsfr-proof possible. The 66020 ollows for more recovery than 
the 68000. Also major changes in the ROM to nrieke it more durable, such as 
recovering from more errors. 

2. New screpbook format sienderds, such as data (for spreadsheets and 
other number manipulators) and text. 

3. Easy tdich modez%\^^\sW\% Implementation of a standard way of using 
an exec file. 

4. Incorporation of cursor k&y usage as an option to the mouse. The new 
keyboard has cursor keys. 

5. Extended grepMcs capability with speed. More transfer modes. 
Animation graphics library. 

6. Applications run in User made for easy conversion to the next 
operating system which will use the MMU and be multi-tasking. 

7. Add capability of tdckground tasks, such as a print spooler, for 
external modules that require it. 
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